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The Story So Far 


$ git clone <url> Download the repo 

$ git checkout <brcinch> Switch to a feature branch 

Edit some files 

$ git commit Commit your changes 

$ git push/pull Sync changes to GitHub 


Merge pull request on GitHub 


Visual Terminology 







Branch label: 


master 
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Preface: Status 


$ git status 
On branch master 

nothing to commit, working directory clean 




Preface: Status 


$ git status 
On branch master 
Changes to be committed: 

(use "git reset HEAD <file>..." to unstage) 

deleted: removed.txt 

Changes not staged for commit: 

(use "git add <file>..." to update what will be committed) 

(use "git checkout — <file>..." to discard changes in working directory) 

modified: modified.txt 

Untracked files: 

(use "git add <file>..." to include in what will be committed) 
added . txt 



Preface: show 


$ git show 

commit 15f81303f58f c7d8f c8f598a8c9be94e783cced2 
Author: David Baumgold <david@davidbaumgold. com> 
Date: Sun Mar 15 21:48:25 2015 -0400 

Detailed commit message 

diff — git a/modified . txt b/modif ied. txt 
index 2579662. .d704eff 100644 
— a/modified . txt 
+++ b/modif ied . txt 
@@ -1 +1 @@ 

This line stayed the same 
-This line was removed 
+This line was added 
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Ch 1: blame 


// 


What the . . . 


who wrote this code? 


// 


$ git blame path/to/file. py 


will tell you who to blame! 




Ch 1: blame 


For each line of the file, blame will find 
the last commit to edit the line, 
and it will tell you: 

• Commit hash 

• Author's name 

• Date of commit 

ProTip: use show to look up the commit message! 


$ git show d47312el 




Ch 1: blame 


25ad0c5f setup. py (Sarina Canelake 2013-07-09 14:42:28 -0400 
24c2a33d setup. py (Calen Pennington 2013-01-04 12:42:17 -0500 
34adc933 xblock/setup. py (Ned Batchelder 2012-11-30 15:20:57 -0500 
deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
ba6d5c45 setup. py (Calen Pennington 2014-11-10 13:50:38 -0500 
ba6d5c45 setup. py (Calen Pennington 2014-11-10 13:50:38 -0500 
'myproject-1.2.0 1 

deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
34adc933 xblock/setup. py (Ned Batchelder 2012-11-30 15:20:57 -0500 
34adc933 xblock/setup. py (Ned Batchelder 2012-11-30 15:20:57 -0500 
deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
deb68879 setup. py (Calen Pennington 2014-11-10 13:33:31 -0500 
34adc933 xblock/setup. py (Ned Batchelder 2012-11-30 15:20:57 -0500 
d47312el setup. py (Ned Batchelder 2014-02-02 07:33:04 -0500 
d47312el setup. py (Ned Batchelder 2014-02-02 07:33:04 -0500 
d47312el setup. py (Ned Batchelder 2014-02-02 07:33:04 -0500 
776c85ce setup. py (Piotr Mitros 2014-07-26 18:30:13 -0400 
d47312el setup. py (Ned Batchelder 2014-02-02 07:33:04 -0500 
ffel375c setup. py (Ned Batchelder 2013-01-22 12:10:21 -0500 
d47312el setup. py (Ned Batchelder 2014-02-02 07:33:04 -0500 
843f42eb setup. py (Calen Pennington 2014-12-11 08:25:51 -0500 
2ac249d5 setup. py (Will Daly 2014-03-13 18:20:48 -0400 
843f42eb setup. py (Calen Pennington 2014-12-11 08:25:51 -0500 
843f42eb setup. py (Calen Pennington 2014-12-11 08:25:51 -0500 
118d4817 setup. py (David Baumgold 2015-03-11 10:05:24 -0400 
118d4817 setup. py (David Baumgold 2015-03-11 10:05:24 -0400 
118d4817 setup. py (David Baumgold 2015-03-11 10:05:24 -0400 
118d4817 setup. py (David Baumgold 2015-03-11 10:05:24 -0400 
118d4817 setup. py (David Baumgold 2015-03-11 10:05:24 -0400 
34adc933 xblock/setup. py (Ned Batchelder 2012-11-30 15:20:57 -0500 


1) Set up for XBlock 

2) from setuptools import setup 

3) 

4) import versioneer 

5) versioneer. VCS = 'git' 

6) versioneer. versionf ile_source = 'xblock/_version. py 1 

7) versioneer. versionf ile_build = 'xblock/_version. py 1 

8) versioneer. tag_prefix = 'xblock-' # tags are like 1.2.0 

9) versioneer. parentdir_prefix = 'XBlock- 1 # dirname like 

10 ) 

11) setup( 

12) name='XBlock' , 

13) version=versioneer.get_version( ) , 

14) cmd c la s s=ve rs ionee r. get_cmd class ( ) , 

15) description^ 'XBlock Core Library 1 , 

16) packages=[ 

17) 'xblock 1 , 

18) 'xblock. django 1 , 

19) 'xblock. reference ' , 

20 ) ], 

21) install_requires= [ 

22) 'Ixml', 

23) ' markupsafe ' , 

24) ' python-dateutil ' , 

25) 'pytz', 

26) 'webob', 

27) ], 

28) license^ 'Apache 2.0', 

29) classif iers=( 

30) "License :: OSI Approved :: Apache Software License 2.0", 

31) ) 

32) ) 



Ch 1: blame 


25ad0c5f setup. py (Sarina Canelake 

24c2a33d setup. py (Calen Pennington 

34adc933 xblock/setup. py (Ned Batchelder 
deb68879 setup. py (Calen Pennington 

deb68879 setup. py (Calen Pennington 


2013-07-09 14:42:28 -0400 1) Set up for XBlock 

2013- 01-04 12:42:17 -0500 2) from setuptools import setup 

2012-11-30 15:20:57 -0500 3) 

2014- 11-10 13:33:31 -0500 4) import versioneer 

2014-11-10 13:33:31 -0500 5) versioneer. VCS = 'git 1 
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Ch2: cherry-pick 



Whoops, I committed to maste 
when I meant to commit 
to my feature branch. 

I need to move my commit!" 




Ch2: cherry-pick 


$ git show 

commit Id5b2e2b273dbb945c6bf5e541d5f Ic725ac906d 
# ... ignore the rest ... 

$ git checkout feature 
Switched to branch 'feature' 

$ git cherry-pick Id5b2e 
[master 8b8d32c] original commit message 
Date: Sun Mar 15 22:04:48 2015 -0400 
1 file changed, 1 insertion(+) 



Ch2: cher 



© 


ry-pick 


cherry-pick 

creates an 

entirely new commit 

based off the original, 

and it 

does not delete 
the original commit 




Ch 3: 



reset 


“ Alright, how do I 
remove J from maste r?" 




Ch 3: reset 


$ git checkout master 
Switched to branch 'master' 

$ git reset — hard HEAD~ 

HEAD is now at 15f8130 made things work 


HEAD == "the commit I'm currently sitting on" 
HEAD~ == "this commit's parent" 

HEAD~~ == "this commit's grandparent" (etc) 




Ch 3: 



reset 


reset reassigns 
the branch pointer 


J will get cleaned up 
by git's garbage collector 

eventually 
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WARNING 


re base is a command for changing history! 
Use its awesome power responsibly! 



wobbly 

timey 

wimey 


is no fun 
when you're on 
the receiving end. 





WARNING 


Never change history when 
other people might be using your branch, 
unless they know you're doing so. 


Never change history on maste r. 


Best practice: only change history 
for commits that have not yet been pushed. 


Ch4: rebase 



''master has changed since 
I started my feature branch, 
and I want to bring 
my branch up to date 

with master. 

What's the best way 
to do that?" 

Don't merge — rebase! 




© © © © © 


Ch4: rebase 


Finds the merge base 
Cherry-picks all commits 
Reassigns the branch pointer 

: ( I ) 

\\) 

The branch has a new base — 

it has been re-based! 





Ch4: rebase 


$ git checkout feature 
Switched to branch 'feature' 

$ git rebase master 

First, rewinding head to replay your work on top of 

it . . . 

Applying: Added B.txt 

Applying: Added another line for B.txt 

Applying: Added a third line for B.txt 




Ch4: rebase 


$ git status 
On branch feature 

Your branch and 'origin/feature 1 have diverged, 
and have 6 and 3 different commits each, 
respectively. 

(use "git pull" to merge the remote branch 
into yours) 

nothing to commit, working directory clean 




Ch4: rebase 







Ch4: rebase 


$ git push 

To git@github. com: singingwolf boy/example. git 
! [rejected] feature -> feature (non-fast-forward) 

error: failed to push some refs to 'git@github. com: singingwolf boy/example. git 1 
hint: Updates were rejected because the tip of your current branch is behind 
hint: its remote counterpart. Integrate the remote changes (e.g. 
hint: 'git pull ...') before pushing again. 

hint: See the 'Note about fast-forwards' in 'git push — help' for details. 


git push is saying: 

"You want me to do what ? 

But that would mean changing history! 
Are you sure that's what you want?" 




Ch4: rebase 

Use git push -f to force it: 


$ git push -f 

Counting objects: 9, done. 

Delta compression using up to 4 threads. 

Compressing objects: 100% (7/7), done. 

Writing objects: 100% (9/9), 946 bytes | 0 bytes/s, done. 
Total 9 (delta 0), reused 0 (delta 0) 

To git@github.com: singingwolf boy/example d ±t 
+ dc206fd. . .ef6a658 feature -> feature (forced update) 




Ch4: rebase 


Sometimes you get conflicts. . . 


$ git rebase master 

First, rewinding head to replay your work on top of it... 

Applying: Adding a different line to A.txt 
Using index info to reconstruct a base tree... 

M A.txt 

Falling back to patchinq base and 3-way merge. . . 

A " J :- me iy±ng A.txt 

CONFLICT (content): Merge conflict in A.txt 

r a _ l^ J ^ ~ m^rnp in thp rhannpc 

Patch failed at 0001 Adding a different line to A.txt 
The copy of the patch that failed is found in: 

/Use rs/sing ingwolf boy/example/. git/ rebase-apply/patch 

When you have resolved this problem, run "git rebase — continue". 

If you prefer to skip this patch, run "git rebase — skip" instead. 

To check out the original branch and stop rebasing, run "git rebase — abort". 



Ch4: rebase 

git status will show you which files are in conflict 


$ git status 

rebase in progress; onto e98d69f 

You are currently rebasing branch 'conflicted' on 'e98d69f'. 

(fix conflicts and then run "git rebase — continue") 

(use "git rebase — skip" to skip this patch) 

(use "git rebase — abort" to check out the original branch) 

Unmerged paths: 

(use "git reset HEAD <file>..." to unstage) 

(use "git add <file>..." to mark resolution) 

both modified: A.txt 

no changes added to commit (use "git add" and/or "git commit -a") 



Ch4: rebase 

Looks the same as a merge conflict! 


$ cat A.txt 
line one 
«««< HEAD 
line two 
line three 


this line is different 

»>»» Adding a different line to A.txt 




Ch4: rebase 


But the resolution is different. . . 


$ git status 

rebase in progress; onto e98d69f 
You are currently rebasing branch 'conflicted' 
on ' e98d69f ' . 

(fix conflicts and then rut "git rebase — continue") 
(use "git rebase — skip" to skip this natch) 

(use "git rebase — abort" to check out the original 
branch) 


git rebase — continue 




Ch4: rebase 


If something's wrong, and you want to start over. . . 


$ git status 

rebase in progress; onto e98d69f 
You are currently rebasing branch 'conflicted 1 
on 1 e98d69f 1 . 

(fix conflicts and then run "git rebase — continue") 
(use "giL reoase to skip this patch) 

(use "git rebase — abort" to check out the original 
branch) 


git rebase — abort 




Ch2: cherry-pick 

You can get conflicts with cherry- pick, as well 


$ git cherry-pick e98d69f0a5942704076182139acb50856ca8bc7c 
error: could not apply e98d69f... Added a third line to A.txt 
hint: after resolving the conflicts, mark the corrected paths 
hint: with 'git add <paths>‘ or 'git rm <paths>' 
hint: and commit the result with 'git commit' 


git status is still your friend ! 




Ch2: cherry-pick 

Resolve the conflicts and then 


$ git status 

On branch conflicted 

You are currently cherry-r'iv.King commit e98d69f. 

(fix conflicts and run "git cherry-pick — continue") 
(use "git cherry-pick — abc , '' t " to cancel the rh^^y- 
pick operation) 


git cherry-pick — continue 




Ch2: cherry-pick 

Not worth the trouble? 


$ git status 
On branch conflicted 

You are currently cherry-picking commit e98d69f. 

(fix co^fii^Li, emu run "yit r herry-pick — continue") 
(use "git cherry-pick — abort" :o cancel the cherry- 
pick OperaLl 


git cherry-pick — abort 
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git log 

shows commits in 

ancestor order 


ref log 


git reflog 

shows commits in 

order of when you 
lasted referenced them 


Ch5: ref log 


''Oh no, I screwed up 
and I want to get back 
to the way things were before, 
but I didn't write down 
the commit hash!" 


reflog to the rescue! 


Ch 5: reflog 


$ git reflog 

909bf0d HEAD@{0}: rebase: aborting 

e98d69f HEAD@{1}: rebase: checkout master 

909bf0d HEAD@{2>: commit: Adding a different line to A.txt 

db06ae9 HEAD@{3>: checkout: moving from db06ae99d4b6 to conflicted 

db06ae9 HEAD@{4}: checkout: moving from master to db06ae99d4b6 

e98d69f HEAD@{5}: checkout: moving from feature to master 

ef6a658 HEAD@{6}: rebase finished: returning to refs/heads/feature 

ef6a658 HEAD@{7>: rebase: Added a third line for B.txt 

f581b81 HEAD@{8}: rebase: Added another line for B.txt 

75f0730 HEAD@{9}: rebase: Added B.txt 

e98d69f HEAD@{10}: rebase: checkout master 


Step 1 : find the commit you want 




Ch 5: reflog 


Step 2: checkout the commit, 

and make sure it's what you want 


$ git checkout 3ca7892 


Step 3: reset the branch pointer 

back to the commit 


$ git checkout feature 
$ git reset — hard 3ca7892 
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Ch 6 : squashing commits 


"Darn, I forgot to include this file 
in the commit I just made!" 


$ git add missing-file.txt 
$ git commit — amend 


Makes a new commit with your file added, 
and replaces the most recent commit with the new one! 
No more "added missing file" commit messages! 




Ch 6 : squashing commits 


But I already have lots of commits like that! 
It's not just my most recent commit. . ." 


$ git rebase — interactive 


Time to bring out the big guns. 




Ch 6 : squashing commits 

Interactive rebase needs somewhere to start. 

To look at the last 5 commits, you can use HEAD~5 

(or use whatever number you want) 


$ git rebase — interactive HEAD~5 


Git will open a file in your text editor, 
so that you can provide further instructions 




Ch 6 : squashing commits 

actions ^ commits 


pick lle8557 First commit! 
pick e98d69f Added a widget 
pick 75f0730 oops, missed a file 
pick f581b81 fixed a typo 
pick ef6a658 Added a second widget 

# Rebase db06ae9. .ef6a658 onto db06ae9 

# 

# Commands: 

# p, pick = use commit 

# r, reword = use commit, but edit the commit message 

# e, edit = use commit, but stop for amending 

# s, squash = use commit, but meld into previous commit 

# f, fixup = like "squash", but discard this commit's log message 

# x, exec = run command (the rest of the line) using shell 


instructions 



Ch 6 : squashing commits 

actions ^ commits 


pick lle8557 First commit! 

pick e98d69f Added a widget 

squash 75f0730 oops, missed a file 
squash f581b81 fixed a typo 
pick ef6a658 Added a second widget 

# Rebase db06ae9. .ef6a658 onto db06ae9 

# 

# Commands: 

# p, pick = use commit 

# r, reword = use commit, but edit the commit message 

# e, edit = use commit, but stop for amending 

# s, squash = use commit, but meld into previous commit 

# f, fixup = like "squash", but discard this commit's log message 

# x, exec = run command (the rest of the line) using shell 


instructions 



Ch 6 : squashing commits 

Saving and quitting your editor 
will cause it to immediately reopen 


# This is a combination of 3 commits. 

# The first commit's message is: 

Added a widget 

# This is the 2nd commit message: 
oops, missed a file 

# This is the 3rd commit message: 
fixed a typo 


so that you can write a new message 
for your single, squashed commit 




Ch 6 : squashing commits 


Save and quit again, 
and Git will apply 
the changes you requested. 
No more "fixed typo" commits! 


WARNING: squashing commits changes history! 

Only do this for unpushed commits! 


Ch 6 : splitting commits 

"My commit is too big, 
can I split it into smaller ones?" 


$ git rebase — interactive 


Let's change some history. 




Ch 6 : splitting commits 


pick 21e8569 First commit! 

pick 198dc9f Did a bunch of things 

pick 79f0c3a Made the corners rounded 

# Rebase db067e9. . 79f0c3a onto db067e9 

# 

# Commands: 

# p, pick = use commit 

# r, reword = use commit, but edit the commit message 

# e, edit = use commit, but stop for amending 

# s, squash = use commit, but meld into previous commit 

# f, fixup = like "squash", but discard this commit's log message 

# x, exec = run command (the rest of the line) using shell 


That second commit looks too big. . . 




Ch 6 : splitting commits 


pick 21e8569 First commit! 

edit 198dc9f Did a bunch of things 

pick 79f0c3a Made the corners rounded 

# Rebase db067e9. . 79f0c3a onto db067e9 

# 

# Commands: 

# p, pick = use commit 

# r, reword = use commit, but edit the commit message 

# e, edit = use commit, but stop for amending 

# s, squash = use commit, but meld into previous commit 

# f, fixup = like "squash", but discard this commit's log message 

# x, exec = run command (the rest of the line) using shell 


So we'll use the edit command! 




Ch 6 : splitting commits 


$ git rebase -i HEAD^3 

Stopped at 198dc9f... Did a bunch of things 
You can amend the commit now, with 

git commit — amend 

Once you are satisfied with your changes, run 
git rebase — continue 


Git will pause in the rebase process, 
and give us as much time as we want 
to create some new commits 




Ch 6 : splitting commits 


The too-big commit is already present, 
so lets pop it off, but keep the changes: 


$ git reset HEAD~ 


Note that I am not using — ha rd, 
because I want to keep the changes 




Ch 6 : splitting commits 


$ git status 

rebase in progress; onto 6b44332 

You are currently editing a commit while rebasing branch 
'feature 1 on '6b44332'. 

(use "git commit — amend" to amend the current commit) 

(use "git rebase — continue" once you are satisfied with your 
changes) 

Untracked files: 

(use "git add <file>..." to include in what will be committed) 

f ilel. py 
f ile2. py 
f ile3. py 


nothing added to commit but untracked files present (use "git 
add" to track) 



Ch 6 : splitting commits 


$ git add filel.py 

$ git commit -m "Detailed message for filel changes" 
[detached HEAD f59aaee] Detailed message for filel changes 
1 file changed, 1 insertion(+) 

$ git add file2.py 

$ git commit -m "Detailed message for file2 changes" 
[detached HEAD cebl6d3] Detailed message for file2 changes 
1 file changed, 1 insertion(+) 

$ git add file3.py 

$ git commit -m "Detailed message for file3 changes" 
[detached HEAD 6d2930a] Detailed message for file3 changes 
1 file changed, 1 insertion(+) 



Ch 6 : splitting commits 


And of course, when we're done: 


$ git rebase — continue 


Finish the rebase, and 
admire your cleaner commit history! 
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Ch 7: bisect 


'The feature's broken? 

But it was working just fine 
two months ago... what changed?" 


bisect will help you quickly find 
the commit that introduced the problem 


Ch 7: bisect 


You need three things to use bisect: 

• A test to determine if things are broken 
(manual is OK, automated is better) 

• A commit where things were working 

• A commit where things are broken 


bisect will use binary search 
to find the commit where 
things went from good to bad 


Ch 7: bisect 


$ git bisect start 
$ git checkout broken-commit 
$ git bisect bad 
$ git checkout working-commit 
$ git bisect good 


Git will checkout the commit in between 
the two you've provided, and ask you 
to test it and determine if its working or broken 




Ch 7: bisect 


If it's working, run 


$ git bisect good 


If it's broken, run 


$ git bisect bad 


Either way. Git will use that information 
to determine the best commit to test next 






Ch 7: bisect 


i — 

Broken 



? 



Ch 7: bisect 


i — 

Broken 



Broken 


A 


1 

Working 


Test here next 


Ch 7: bisect 


i — 

Broken 


▲ 


Working 



1 

Working 


Test here next 


And keep going recursively. . . . 


Ch 7: bisect 


If you have an automated test, it's even faster! 


$ git bisect run my_test.sh 


With that. Git can 
test, checkout, test, checkout, test 
until it finds the commit 
that caused the failure 
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There’s so much more... 


$ git help rebase 


http://git-scm.com/doc 


http://help.github.com 




O’REILLY’ 


Head First 






A Brain-Friendlv Guide 


)8SC 

Change history without 
tying yourself in knots 


Editing has never 
been so enlightening 


Compatible 
with all kinds 
of text, not 
just software 


Learn how 
to travel 
through 
time 


A learner’s guide to Git 


Discover the 
freedom in 
branching, 
forking, 

& merging 


i 



David Baumgold 



Any questions? 


David Baumgold 
@singingwolfboy 


As a reminder, we covered 

blame cherry-pick reset rebase 
reflog squash split bisect 


Book: davidbaumgold.com/book 


Slides: bit.lv/ git-pydx-2016 


